home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / hold me in your arms / Virtual-Worlds / commercial / vart_3d_object < prev    next >
Internet Message Format  |  1993-04-05  |  8KB
  1. From: petav@Physik.TU-Muenchen.DE (Peter Averkamp)
  2. Subject: SOFTWARE: ANNOUNCING the vart 3D object toolbox for Khoros
  3. Summary: Vart is a 3d visualization toolbox for Khoros
  4. Keywords: Khoros,visualization,3d
  5. Organization: Leibniz-Rechenzentrum, Muenchen (Germany)
  6. Date: Tue, 6 Apr 1993 13:17:43 GMT
  7. Lines: 158
  8.  
  9. Crossposted from comp.graphics.visualization
  10.  
  11.  
  12.     ---------------------------------------------------
  13.     Announcing the vart 3D object toolbox for Khoros 1
  14.     ---------------------------------------------------
  15.     Version: 0.4, by Peter Averkamp
  16.  
  17.  
  18. I finally found the time to wrap up this toolbox for public release.
  19. Big excuses to all who have been waiting longer than planned, but lots
  20. of other work from my real job was very pressing. In case you're
  21. wondering why I start this with a version number 0.4, this is simply
  22. the generation number of rewrites that vart has already undergone and
  23. some of you may have got previous versions already.
  24.  
  25. This will be the last version for Khoros 1, as all future work will go
  26. into K2. I am aware of the fact that this version is currently far
  27. from complete; especially the handling of hierarchy is not satisfying
  28. yet. But I tried to make available all basic functions needed to
  29. create even very complex 3D visualizations. I hope that some of you
  30. have use for what's available, even though the manpages are currently
  31. terse at best (In any case of doubt, you can always look at the source
  32. 8=) ). Sorry to say that there is not even a short tutorial available
  33. (yet), but I know that some more-qualified person is in charge of a
  34. real elaborate visualization guide for K2.
  35.  
  36. I will try to collect some useful examples and hints and make them
  37. available as a bundled tar collection within the next few weeks.
  38.  
  39. Be aware that none of the formats this release uses is guaranteed to
  40. work with upcoming versions, as K2 offers radically different
  41. capabilities.  I will try though, to make conversion paths available.
  42.  
  43. Short Description:
  44. =================
  45.  
  46.     vart is a toolbox to create 3D object descriptions for visualisation.
  47.     It contains modules for generating objects from regular viff data files,
  48.     modules for specifying properties for the objects, and modules to create
  49.     complex combinations of objects and rendering parameters. A high-quality
  50.     (and low speed) portable renderer is included that creates regular viff
  51.     images of the objects. The current version number 0.4 is the first
  52.     public release and still by no means complete. Some modules are even
  53.     in a rather preliminary state and are likely to change dramatically over
  54.     time. 
  55.  
  56. Credits:
  57. ========
  58.  
  59.     vart uses quite a bit of previously written code by various people;
  60.     a_ray and a_text have been developed from the vort package.
  61.     I wish to thank Erich Echidna and David Hook from the Department of
  62.     Engineering Computer Resources, University of Melbourne, Australia
  63.     and the many people who made vort possible. From the vort thank-you list
  64.     I pulled the names: Alberto Barsella,Henry Chatroop, Ole Nielsen,
  65.     Joe Lappa,Joel Welling,Pavel Rozalski and Eric Haines.
  66.     a_iso is a direct Khoros implementation of isobuild. I wish to thank
  67.     Brian Tierney from the Imaging Technologies Group at Lawrence Berkeley 
  68.     Laboratory for making this Implementation of Lorenzen & Cline's 
  69.     marching cubes algorithm available.
  70.  
  71.     And last but not least the Khoros group cannot be thanked enough for
  72.     their excellent system.
  73.  
  74.  
  75. available modules:
  76. ==================
  77.  
  78.     a_2Dfield (1)     -  Create a Z-field object 
  79.     a_box (1)         -  create Box object(s) 
  80.     a_colour (1)     -  create a colour definition 
  81.     a_combine (1)     -  Combine scene objects 
  82.     a_cylindr (1)     -  create Cylindrical object(s) 
  83.     a_group (1)     -  group object(s) 
  84.     a_instant (1)     -  instantiate a named object 
  85.     a_iso (1)         -  create an isosurface from a viff volume 
  86.     a_light (1)     -  create a light source 
  87.     a_materl (1)     -  create a Material specification 
  88.     a_polygon (1)     -  create Polygon object(s) 
  89.     a_ray (1)         -  Raytrace a scene file 
  90.     a_scene (1)     -  Create a scene file 
  91.     a_sphere (1)     -  create Sperical object(s) 
  92.     a_text (1)         -  Create a 3D text object 
  93.     a_texture (1)     -  create a Texture specification 
  94.     a_trafo (1)     -  create an object Transformation 
  95.     a_vox (1)         -  Create a voxel volume dataset 
  96.     cmap2viff (1)     -  write the colormap of a file into a VIFF image 
  97.     loc2viff (1)     -  write the location data of a file into a VIFF image 
  98.     viff2cmap (1)     -  Change a VIFF image into a colormap file 
  99.     viff2loc (1)     -  convert a VIFF image into location data 
  100.     la_ray (3)         -  Vort Raytracer for Khoros 
  101.  
  102.  
  103. INSTALLATION:
  104. =============
  105.  
  106.     To unpack vart, cd to the directory where your tolboxes reside and
  107.     type 'zcat <path where you ftp-ed it>/vart.0.4.tar.Z | tar xvof -'
  108.     This will create the directory 'vart', where all files pertaining
  109.     to the toolbox will reside.
  110.  
  111.     I have hacked together a quick installation Makefile in the vart directory.
  112.     If all you want is install vart on a single architecture with reasonable
  113.     defaults, you should give it a try:
  114.  
  115.     1.If you decided to get pre-made vart binaries:
  116.  
  117.       type 'zcat <path where you ftp-ed it>/vart-decbin.0.4.tar.Z | tar xvof -'
  118.       type 'cd vart'
  119.       type 'make toolboxfile config fonts message'
  120.  
  121.       To use the a_text binary, you need to set the environment variable
  122.       VFONTLIB to point to `pwd`/repos/fonts/binfonts
  123.       I recommend adding this environment variable to your shell rc file, 
  124.       csh users can simply type 'make fontenv'
  125.  
  126.     2.If you are building from source:
  127.  
  128.       All you need to do is init your Khoros environment variables, 
  129.       cd to the directory 'vart' and type make. If you get some warnings
  130.       about Toolbox files, read what make says, fix the problem accordingly
  131.       and start over by typing 'make' again. Don't panic, if at some point 
  132.       you see warnings about lex rules. That's normal.
  133.  
  134.  
  135.     You can, of course use the khoros tools to do the installation as well.
  136.     Look in volume2,Chapter11 for details. You need to watch some points:
  137.  
  138.        -type 'make fonts canren' before doing anything else.
  139.        -vart should be linked statically on the sun
  140.       
  141.     For ease-of-use it is recommended to include repos/.Keywords in your
  142.     KHOROS_KEYWORDS file or ,if necessary, to create it. As the objects in
  143.     vart are currently rather primitive, the extensive use of keywords for
  144.     symbolical object definitions can greatly enhance the usefullness of vart.
  145.  
  146.     To get a feeling of how the fonts from a_text look like, you can print
  147.     out the files in repos/fonts/ps by typing 'make printfonts'.
  148.  
  149. Bugs:
  150. =====
  151.     If you find any of the many bugs please fill out the Khoros bug report
  152.     form in $KHOROS_HOME/repos/BugReport and mail it to
  153.     vart-bugs@e20.physik.tu-muenchen.de
  154.     Bugfixes, suggestions, etc, should be clearly marked as such on the 
  155.     subject line and go to the same address. If you mail me directly about
  156.     vart, your mail is most likely discarded by my mail processor.
  157.  
  158.  
  159. Latest copies of vart are available by anonymous ftp to:
  160.     ftp.eece.unm.edu:/pub/khoros/contrib/vart*
  161.     ftp.e20.physik.tu-muenchen.de:/khoros/contrib/vart*
  162.  
  163.  
  164.   Peter Averkamp, April 1993
  165.  
  166.  
  167. --
  168. Peter Averkamp,                      | email:
  169. Physics Department E20               | petav@radon.e20.physik.tu-muenchen.de
  170. Techn. Univ. of Munich               | Phone: ++49 (89) 3209-2408
  171. D-8046 Garching, Germany             | Fax:   ++49 (89) 3209-2338
  172.  
  173.  
  174.  
  175.